From 67d1183ac905bf32d0340fe2ac04bb28f6026867 Mon Sep 17 00:00:00 2001
From: =?utf8?q?S=C3=A9bastien=20Wilmet?= <swilmet@gnome.org>
Date: Tue, 25 Jun 2013 11:58:57 +0200
Subject: [PATCH] Document GtkTextSearchFlags

Move the doc about the flags from gtk_text_iter_forward_search() to the
enum.

https://bugzilla.gnome.org/show_bug.cgi?id=390048
---
 gtk/gtktextiter.c | 12 +-----------
 gtk/gtktextiter.h | 15 +++++++++++++++
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/gtk/gtktextiter.c b/gtk/gtktextiter.c
index 474cfe5953..84a0ec8336 100644
--- a/gtk/gtktextiter.c
+++ b/gtk/gtktextiter.c
@@ -4858,18 +4858,8 @@ strbreakup (const char *string,
  * @limit. Note that a search is a linear or O(n) operation, so you
  * may wish to use @limit to avoid locking up your UI on large
  * buffers.
- * 
- * If the #GTK_TEXT_SEARCH_VISIBLE_ONLY flag is present, the match may
- * have invisible text interspersed in @str. i.e. @str will be a
- * possibly-noncontiguous subsequence of the matched range. similarly,
- * if you specify #GTK_TEXT_SEARCH_TEXT_ONLY, the match may have
- * pixbufs or child widgets mixed inside the matched range. If these
- * flags are not given, the match must be exact; the special 0xFFFC
- * character in @str will match embedded pixbufs or child widgets.
- * If you specify the #GTK_TEXT_SEARCH_CASE_INSENSITIVE flag, the text will
- * be matched regardless of what case it is in.
  *
- * Return value: whether a match was found
+ * Returns: whether a match was found
  **/
 gboolean
 gtk_text_iter_forward_search (const GtkTextIter *iter,
diff --git a/gtk/gtktextiter.h b/gtk/gtktextiter.h
index 830d28e14a..57ce274f8e 100644
--- a/gtk/gtktextiter.h
+++ b/gtk/gtktextiter.h
@@ -35,6 +35,21 @@
 
 G_BEGIN_DECLS
 
+/**
+ * GtkTextSearchFlags:
+ * @GTK_TEXT_SEARCH_VISIBLE_ONLY: Search only visible data. A search match may
+ * have invisible text interspersed.
+ * @GTK_TEXT_SEARCH_TEXT_ONLY: Search only text. A match may have pixbufs or
+ * child widgets mixed inside the matched range.
+ * @GTK_TEXT_SEARCH_CASE_INSENSITIVE: The text will be matched regardless of
+ * what case it is in.
+ *
+ * Flags affecting how a search is done.
+ *
+ * If neither #GTK_TEXT_SEARCH_VISIBLE_ONLY nor #GTK_TEXT_SEARCH_TEXT_ONLY are
+ * enabled, the match must be exact; the special 0xFFFC character will match
+ * embedded pixbufs or child widgets.
+ */
 typedef enum {
   GTK_TEXT_SEARCH_VISIBLE_ONLY     = 1 << 0,
   GTK_TEXT_SEARCH_TEXT_ONLY        = 1 << 1,
-- 
2.30.2